home *** CD-ROM | disk | FTP | other *** search
/ MIDICraft's MIDINET CD-ROM / MIDICraft's MIDINET CD-ROM.iso / DOSUTILS / EXCHI3.DOC < prev    next >
Text File  |  1997-01-12  |  8KB  |  235 lines
  1.         ******************************
  2.             SENDI3/RECVI3 v1.2
  3.             (DOS with MPU, SOUNDBLASTER)
  4.     
  5.           send and receive korg i2/i3 dumps
  6.               by Guenter Nagler 
  7.                 1996 
  8.           (gnagler@ihm.tu-graz.ac.at)
  9.         ******************************
  10.  
  11. [1] BACKGROUND
  12. KORG i2/i3 keyboards store can their data on 720KB floppy disks in
  13. files with extensions 
  14.    *.pcg  program data (64 programs + 2 drum kits)
  15.    *.sty  style data  (4 styles)
  16.    *.arr  arrangement data (64 programs)
  17.    *.sng  song data (10 songs)
  18.    *.bsq  backing sequence data (10 backing sequences)
  19.  
  20. I defined additional data files:
  21.    *.glb  global data 
  22.    *.dkt  drumkit data
  23.  
  24. The keyboard supports data dump exchange via midi cable.
  25. These utilities communicate with the keyboard and send and
  26. request/receive such dumps. 
  27.  
  28. send:
  29. The sendi3 utility reads korg files and convert them to korg dumps and send
  30. them to the keyboard. After sending the keyboard usually sends
  31. back a reply (data load completed or data format error).
  32. The sendi3 utility tries to catch these message.
  33.  
  34. receive:
  35. The recvi3 utility listens to the keyboard and requests a dump. Then it
  36. waits for reaction of the keyboard which should send the dump immediately.
  37. The utility catches the dump decodes it and converts it into a korg file.
  38.  
  39. [2] FILES DESCRIPTION
  40.  
  41. SENDI3.EXE..........MSDOS executable for sending korg i3 files
  42. RECVI3.EXE..........MSDOS executable for receiving korg i3 files
  43. EXCHI3.DOC..........this file, showing usage of SENDI3.EXE and RECVI3.EXE
  44.  
  45. [3] COPYRIGHT
  46.  
  47. SENDI3 and RECVI3 (c) 1996 were created by Guenter Nagler.
  48.  
  49. SENDI3 and RECVI3 are free and may be used as you wish with this one exception:
  50.  
  51.     You may NOT charge any fee or derive any profit for distribution
  52.     of SENDI3 and RECVI3.  Thus, you may NOT sell or bundle SENDI3/RECVI3 
  53.     with any product in a retail environment (shareware disk distribution, 
  54.     CD-ROM, etc.) without permission of the author.
  55.  
  56. You may give SENDI3 and RECVI3 to your friends, upload it to a BBS, or ftp it to
  57. another internet site, as long as you don't charge anything for it.
  58.  
  59. [4] DISCLAIMER
  60.  
  61. SENDI3 and RECVI3 were designed to read and write original KORG i3 files.
  62. Communications are done using original Roland MPU-401 (tm) and 
  63. Creative Labs Soundblaster (tm) midi interfaces.
  64.  
  65. Use SENDI3 at your own risk.  Anything you do with SENDI3 is your
  66. responsibility, and not the author's.  Any damage caused to any person,
  67. computer, software, hardware, company, or business by running SENDI3 
  68. is your responsibility, and the author will not be liable.
  69.  
  70. If you don't understand these terms, or are not sure of something, or
  71. are afraid something bad might come of using SENDI3, don't  use  it!
  72. You are here forewarned.
  73.  
  74. [5] INSTALLATION 
  75.  
  76.   Simply copy SENDI3.EXE and RECVI3 into a directory that is in your path.
  77.  
  78.   C:\> SENDI3 
  79.  
  80.   C:\> RECVI3 -h
  81.  
  82.   you should get the usage text (see next section)
  83.  
  84. [6] USAGE
  85.  
  86. usage: sendi3 [-prog xxx] filename ...
  87. files are korg i3 files (pcg, sty, arr, bsq, sng) or glb, drk
  88. prog xxx  send only program xxx of given pcg
  89. pcg    korg i3 programs
  90. sty    korg i3 styles
  91. arr    korg i3 arrangements
  92. bsq    korg i3 backing sequences
  93. sng    korg i3 songs
  94. glb    korg i3 global settings
  95. drk    korg i3 drumkit parameters
  96. dos wildcards (*, ?) can be used
  97.  
  98. usage: recvi3 [-identify] [filename]
  99. -identify    request identification of KORG i3 keyboard
  100. filename    should have extension *,PCG,STY,ARR,SNG,BSQ,GLB,DKT
  101. When no filename specified then dump must be sent manually
  102.  
  103. Important:
  104.   To exchange data dumps with the keyboard the keyboard must be turned on
  105.   and global data parameter EXCL set to ON.
  106.  
  107. Important:
  108.   This program works only with a MPU-401 or Soundblaster compatible 
  109.   midi interface. For soundblaster cards the environment variable BLASTER
  110.   must be set to select the correct soundcard port number (A220,A240,A260,A280).
  111.   The MPU midi port must be 300 or 330 or specified in the environment variable 
  112.   MPU (hexadezimal port number).
  113.  
  114. e.g. 
  115. set BLASTER=A240 I5 D0 H5 P300 T6  
  116. set MPU=210
  117.  
  118. Warning: 
  119.   sendi3 will change most settings of the keyboard.
  120.   Backup your current settings to a floppy disk (Disk - Save all data), 
  121.   so that you can restore this state.
  122.  
  123. Warning:
  124.   korg i3 data dumps do not allow to receive all parameters that are 
  125.   stored in an original PCG file (e.g. Protect Program, EXCL ON/OFF, ...)
  126.   recvi3 will save a PCG that contains only program data.
  127.   This should not be a big disadvantage because usually the missing settings
  128.   are set manually only once and should stay forever.
  129.   
  130. [7] SUGGESTIONS / COMMENTS / BUG REPORTS / QUESTIONS
  131.  
  132.          WWW:    http://hgiicm.tu-graz.ac.at/Cpub
  133.           contains all my dos/unix midi programs
  134.          EMAIL:  gnagler@ihm.tu-graz.ac.at
  135.  
  136. [8] EXAMPLES
  137.  
  138. First backup your current keyboard settings manually to a floppy disk!
  139.  
  140. Ask KORG i2/i3 to identify itself:
  141. C:\> recvi3 -identify
  142. KORG responded
  143. 15 bytes received: identification:  F0 7E 00 06 02 42 39 00 00 00 17 00 01 00 F7
  144. Manufacturer id: 42 Korg
  145. Family code: 39h  i2/i3
  146. Member code: 00h  i3
  147. ROM No: 00h (0)
  148. Software Version: 17h (23)
  149.  
  150.  
  151. Get all current settings (all that Korg i2/i3 can send through dump):
  152. C:\> recvi3 backup.*
  153. KORG responded
  154. requesting dump from KORG
  155. saved global data to BACKUP.GLB
  156. saved drumkit data to BACKUP.DKT
  157. saved program data to BACKUP.PRG
  158. saved style data to BACKUP.STY
  159. saved arrangement data to BACKUP.ARR
  160. saved backing sequence data to BACKUP.BSQ
  161. saved song sequence data to BACKUP.BSQ
  162.  
  163. Receive an "all program dump" that will be sent manually from the keyboard:
  164. C:\> recvi3 manually
  165. KORG responded.
  166. Waiting for receiving KORG dumps. Abort with <esc>
  167. 7 bytes received: mode changed to GLOBAL
  168. 11 bytes received: drumkit parameter changed in Dr1 Param 0 to Value 0
  169. 11 bytes received: drumkit parameter changed in Dr2 Param 0 to Value 0
  170. 12377 bytes received: all program data dump
  171. saved program data to MANUALLY.PRG
  172.  
  173. This will save all dumps sent manually and shows all EXCL messages sent by 
  174. the keyboard.
  175.  
  176. Load a full KORG environment:
  177. C:\> sendi3 macarena.*
  178. KORG responded
  179. file MACARENA.TXT ignored
  180. sending MACARENA.PCG to KORG ...
  181. korg answered: data load completed
  182. sending MACARENA.STY to KORG ...
  183. korg answered: data load completed
  184. sending MACARENA.ARR to KORG ...
  185. korg answered: data load completed
  186. sending MACARENA.BSQ to KORG ...
  187. korg answered: data load completed
  188.  
  189. set new programs only
  190. C:\> sendi3 8_beat.pcg
  191. KORG responded
  192. sending 8_BEAT.PCG to KORG ...
  193. korg answered: data load completed
  194.  
  195. Hint: The programs will be available at Program Bank D and drumkits
  196. at user drumkits Drum7 and Drum8
  197.  
  198. More than one file per type cannot be sent:
  199. C:\> sendi3 8*.*
  200. cannot send more than one arrangement data file (80THGOLD.ARR,8_BEAT.ARR)
  201.  
  202. Send single program and save it in a certain user program
  203. goto program mode and select a user program place that will be used
  204.  
  205. Hint: The program place will be used temporarily and will not be saved
  206. automatically. You can use any place to test a program and save it with
  207. Write Program Key.
  208.  
  209. Use findi3 to find the program wanted (*.pcg).
  210. You need the pcg filename and program place (D11-D88,Dr7,Dr8) or program name.
  211.  
  212. C:> findi3 mini
  213. DoubleMini   D37  PRELOAD.PCG
  214. C:\> sendi3 -prog D37 preload.pcg
  215. or 
  216. C:\> sendi3 -prog doublemini preload.pcg
  217.  
  218. Hint: If the program name contains spaces or other not DOS compatible characters
  219. then use the program place instead or use "..." 
  220.  
  221. The program will change to program edit mode and transfer the program.
  222. You can play it immediately after successful notification.
  223.  
  224. The program will be forgotten if any other program is selected.
  225. Use Write Program Key or Write Program function (edit program/utility)
  226. to save the program.
  227.  
  228. [9] CHANGES
  229. v1.0 to v1.1:
  230.   * allow MPU port other than 300 or 330 (environment variable MPU)
  231.  
  232. v1.1 to v1.2:
  233.   * better MPU support
  234.   * option -prog in sendi3 to send single programs 
  235.